home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / emulation / unpit / unpit.doc < prev    next >
Text File  |  1999-05-14  |  3KB  |  73 lines
  1.  
  2.                               INTRODUCTION
  3.  
  4.  
  5.         unpit - Macintosh PackIt file unpacker
  6.  
  7.         Version 2, for PackIt II
  8.  
  9. This program will unpack a Macintosh PackIt file into separate files.  The
  10. data fork of a PackIt file contains both the data and resource forks of the
  11. packed files.  The program will unpack each Mac file into separate .data,
  12. .rsrc., and .info files that can be downloaded to a Mac using macput.
  13.  
  14.  
  15.                                  USAGE
  16.  
  17. The program syntax is much like macput/macget:
  18.  
  19.     unpit [-rdu] packit-file.data
  20.  
  21. The  -r and -d flags will cause only the resource and data forks to be
  22. written.  The -u flag will cause only the data fork to be written and
  23. to have carriage return characters changed to Unix newline characters.
  24.  
  25.  
  26.                                AUTHOR
  27.                                
  28. Some of the program is borrowed from the macput.c/macget.c programs.
  29.  
  30.     Author: Allan G. Weber, (Weber%Brand@USC-ECL)        
  31.     Date:   September 30, 1985
  32.     Revised: January 24, 1986 - added CRC checking
  33.          March 25, 1986 - support compressed mode of PackIt II,
  34.                   check for illegal Unix file names
  35.  
  36.    Amiga porting by Fabrizio "Lanch^DarkAge" Bartoloni
  37.    <lanch@caribusiness.it>
  38.  
  39.  
  40.                               TECHNICAL MATTERS
  41.  
  42.  There is some confusion as to what to do with the "inited" flag in the
  43.    finder info bytes that are in the header of each file in the packit file.
  44.    If this flag bit is copied to the .info file, it seems to confuse
  45.    MacTerminal into placing the file icons in the upper left corner of the
  46.    window on top of each other.  Setting this bit to zero in the .info file
  47.    seems to fix that problem but may cause others.  I haven't been able to
  48.    find any .info files that have this flag set so making it zero may be OK.
  49.    Anyway, MacTerminal seems to set the flag when it create the file on the
  50.    Mac.  The "#define INITED_BUG" can be used to try both settings.
  51.  
  52.  
  53. Format of a Packit file:
  54.  
  55. Repeat the following sequence for each file in the Packit file:
  56.  
  57.     4 byte identifier ("PMag" = not compressed, "Pma4" = compressed)
  58.     variable length compression data (if compressed file)
  59.     92 byte header (see struct pit_header below) *
  60.     2 bytes CRC number *
  61.     data fork (length from header) *
  62.     resource fork (length from header) *
  63.     2 bytes CRC number *
  64.  
  65. Last file is followed by the 4 byte Ascii string, "Pend", and then the EOF.
  66.  
  67. * these are in compressed form if compression is on for the file
  68.  
  69.  
  70.                             DISCLAIMER
  71.  
  72.  Program provided "AS IS", no warranty. take care!
  73.